home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / apps / pcgopher / ugopher.doc < prev    next >
Encoding:
Text File  |  1992-10-30  |  8.0 KB  |  204 lines
  1.          Internet Gopher Curses Client Documentation
  2.                University of Minnesota
  3.  
  4.  
  5. I. Overview of the Internet Gopher Curses Client.
  6.  
  7. The Internet Gopher is a distributed document delivery service.  It
  8. allows a neophyte user to access various types of data residing on
  9. multiple hosts in a seamless fashion.  This is accomplished by
  10. presenting the user a hierarchical arrangement of documents and by
  11. using a client-server communications model.  The Internet Gopher
  12. Curses Client allows a user on a terminal to access the vast array of
  13. information available on various gopher servers.
  14.  
  15. II.  Installing Gopher
  16.  
  17. Copy UGOPHER.EXE and GOPHER.HLP to any directory together. The program
  18. expects to find its help file in the same directory as the executable.
  19. If you are using Microsoft Windows 3.x, copy GOPHER.PIF to a directory
  20. in your path and use PIFEDIT to change the startup directory.
  21.  
  22. III. Using Gopher
  23.  
  24. To use the gopher just type "ugopher".  You will be connected up to the
  25. root gopher server.  You can aim the Gopher client at an alternative
  26. server if you wish.  Just give the parameters on the command line like
  27. this: 
  28.  
  29. % gopher cwis.uth.tmc.edu 70
  30.  
  31. There are several options available.
  32.    The '-s' option flag disables saving and printing in the client.  This
  33. is quite useful for gopher clients that are publicly accessable. 
  34.   The '-p path' flag specifies the initial directory path for the
  35. initial server.
  36.   The '-t title' flag replaces the default initial title with the one
  37. specified on the command line.
  38.  
  39. The following commands are available in the browsing mode.
  40.  
  41. l <Return>  <Cursor Right>    View current item.
  42. <Number>                Move to a line #.
  43. k C-p <Cursor Up>        Move pointer up.
  44. j C-n <Cursor Down>        Move pointer down.
  45. > <PageUp>            Previous Page.
  46. < <PageDown>            Next Page.
  47. h u <Cursor Left>        Go up a level.
  48. m                Go to the first screen.
  49. Q                       Exit Internet Gopher.
  50. O                       Change Gopher Options.
  51. !                Shell to DOS (unless in Secure Mode)
  52. ?                       This help screen.
  53.  
  54. Note that the hjkl grouping is backup/down/up/forward.
  55.  
  56. Each object can be identified by it's "extension"
  57.  
  58. /           Item is a directory.
  59. .           Item is a text file.
  60. <?>         Item is a search index.
  61. <CSO>       Item is a CSO phone book.
  62. <TEL>       Item is a telnet session.
  63. <GIF>       Item is a GIF file.
  64. <Picture>   Item is an image.
  65. <MIME>        Item is a MIME message.
  66. <)          Item is a sound (looks like a speaker)
  67.  
  68.  
  69.  
  70. Notes on the DOS PC/TCP port:
  71.  
  72. The Internet Gopher program is copyright (C) 1991, 1992 University of
  73. Minnesota Microcomputer Workstations and Networks Center.
  74.  
  75. This port is essentially true to the unix curses version.  A curses
  76. emulation for DOS by Bjorn Larsson was used, with a bit of tweaking to
  77. make it properly recognize screens with more than the normal 24 lines if
  78. you have EGA or better.
  79.  
  80. The sound option is enabled, but not set to anything.  If you have
  81. utilities to play sounds on your PC you may use them.
  82.  
  83. In addition, support for getting and viewing CompuServe GIF format files
  84. has been added.  The GIF viewer can be set in the options screen.
  85.  
  86. During my work porting v. 0.9 to DOS, the folks at Minnesota release v 1.0.
  87. Of the changes included in that release, I implemented these:
  88.  
  89.      You can use environment variables to set up the various commands.
  90.  
  91.           PAGER -  text file browser.
  92.           PLAYER - audio player.
  93.           VIEWER - image viewer.
  94.           MAILER - mail command.
  95.       TELNET - telnet command.
  96.       TN3270 - 3270 emulator command.
  97.       MIMECMD - MIME pager (Multipurpose Internet Mail Extensions)
  98.  
  99.      These are all optional, you may use the defaults or set them with
  100.      the options screen in ugopher.
  101.  
  102.      Two environment variables can be set to tell ugopher where to put
  103.      certain files:
  104.          TEMP or TMP - ugopher with write temporary files here.  If
  105.          not set ugopher will use whatever the current directory is.
  106.          HOME - ugopher will look for and write its config file,
  107.          _gopher.rc, in this directory if set, otherwise the file
  108.          resides in the directory the executable is in.  That is, if
  109.      ugopher.exe is in C:\DWSNET, _gopher.rc will be there, too.
  110.      Again, these are both optional ugopher will work fine if they are
  111.      not set.
  112.  
  113.      User can now escape from the Telnet/TN3270 connection screen.
  114.  
  115.      Client now does nifty twirl output to let you know it's up to
  116.      something.  It currently does this for directories (one twirl per
  117.      entry) and textfiles/cso searches (one twirl per 25 lines)  This
  118.      stuff is adapted from the panda code.
  119.  
  120.      Added more information on connections.  It displays "connecting..."
  121.      before it displays "retrieving directory..."
  122.  
  123.      Client beeps at you if you press the wrong keys now.
  124.  
  125.      The client doesn't redisplay the menu when an invalid key is pressed.
  126.      
  127.      Added fix from John Sellens that allows the user to escape from a CSO
  128.      query.
  129.  
  130.      Made the interface more consistent.  Pressing 'l' will let you
  131.      enter into an item (just like return and the right arrow..)
  132.      Pressing 'h' will go up a level.  (Glenn F. Leavell). 
  133.  
  134. **One of the two big changes for v 1.0, bookmarks, was NOT implemented.
  135.  
  136. I also squished a few bugs:
  137.  
  138. Curses routines were getting called after after the program shut down
  139. the curses environment to shell out, but before reinitialize curses.
  140. Apparently this is harmless in unix, but the DOS emulation would hang.
  141.  
  142. After retrieving a file from a gopher server the connection was not getting
  143. closed.  The result was that eventually gopher would use up all the PC/TCP
  144. kernel's configured tcp connections, and not release them until it exited.
  145.  
  146. When you go up a menu or return to the root menu, the title is reset
  147. correctly.
  148.  
  149. Some malloc()'ed memory was not getting freed.  I can't say for sure I've
  150. cleaned every stray memory leak, but it is much better.
  151.  
  152. Changes from v0.95 to v0.96, August 23, 1996:
  153.  
  154. Allow for Saving of configuration using _gopher.rc in either the same
  155. directory as the executable or $HOME if set.
  156.  
  157. Make tmpfiles that don't step on each other -- allow for multiple
  158. instances running from the same disk.  Temporary files will be put in
  159. the directory specified by TEMP or TMP one exists.  Next will use any
  160. TMPdir found in _gopher.rc.  Otherwise files will be created in the
  161. current directory.
  162.  
  163. GOPHERHELP expected to b in the directory the executable is in instead
  164. of the current directory.
  165.  
  166. Fixed bug where sometimes builtin pager skips past the quit/mail/save
  167. prompt. 
  168.  
  169. Made sure install.bat puts gopher.hlp and gopher.pif in c:\dwsnet
  170.  
  171. Fixed controlc() so that the right filename is removed (usually).
  172.  
  173. Improved performance in return of item listings and text files by
  174. implementing read ahead buffering of data from the net. 
  175.  
  176. Last file name used to save a file was showing up as email address to
  177. mail to -- file name is zeroed out now, email address is kept.
  178.  
  179. Changes September 29, 1992
  180.  
  181. Support for Multimedia Internet Mail Extension files has been added.
  182. Support for the IMAGE type, treated identically to GIF.
  183. Support for TN3270.
  184.  
  185. Typing '!' will shell to DOS unless you are running in Secure Mode.
  186.  
  187. Can now search the directory entries -- use '/' for the first search,
  188. then 'n' for more of the same (like in vi).
  189. ----
  190.  
  191. The gopher client was ported to DOS and PC/TCP by the Steven E. Newton
  192. of the University of Texas Health Science Center Office of Academic
  193. Computing. The Lan Workplace and PC-NFS versions were done by Stan
  194. Barber of Baylor College of Medicine. You may send email to
  195. gopher@oac.hsc.uth.tmc.edu for questions or bug reports. 
  196.  
  197. This product uses the SPAWNO v4.10 routines by Ralf Brown to minimize memory
  198. use while shelling to DOS and running other programs.
  199. SPAWNO v4.10    4/26/91    disk/EMS/XMS/INT15 swapping replacement for spawn()
  200. (c) Copyright 1990,1991,1992 Ralf Brown.  All Rights Reserved.
  201.  
  202. If this causes you problems you may obtain a version that does not use
  203. SPAWNO by contacting the Office of Academic Computing.
  204.